Description

Adds a persistent per-student course bookmark and wishlist system with shared frontend state, optimistic updates, filtering, sorting, navigation counts, and safe handling of unavailable courses.

Fixes #19

Backend changes

• Added a dedicated course-bookmark Mongoose model

• Added a compound unique index on user ID and course ID

• Added protected student-only bookmark routes

• Added endpoints to:

  • Save a course
  • Remove a saved course
  • Retrieve saved courses
  • Check bookmark state for multiple courses
  • Clear all saved courses

• Added duplicate prevention

• Added pagination

• Added course, category, and educator search

• Added category filtering

• Added free and paid filtering

• Added available and deleted-course filtering

• Added recently saved, title, and price sorting

• Added safe handling for courses removed after being bookmarked

Frontend changes

• Added a shared BookmarksProvider
• Added reusable BookmarkButton
• Added a responsive Saved Courses page
• Added a reusable navigation link with live bookmark count
• Added optimistic save/remove updates
• Added rollback when an API request fails
• Added cross-page bookmark synchronization
• Added search, filters, sorting, pagination, loading, empty, and error states
• Added responsive desktop, tablet, and mobile layouts
• Added keyboard-accessible bookmark controls

Persistence and synchronization

Bookmark data is stored per authenticated student in MongoDB.

Bookmark state remains synchronized across:

• Course catalog cards
• Course content/detail pages
• Saved Courses page
• Navigation count

The state also reloads correctly after a page refresh.

Validation

• Backend syntax checks passed
• Frontend production build passed
• Logged-out users are redirected to login
• Students can save courses
• Duplicate bookmarks are prevented
• Students see only their own bookmarks
• Bookmark state persists after refresh
• Catalog and course page state remain synchronized
• Optimistic updates roll back on request failure
• Search works
• Category filtering works
• Free and paid filtering works
• Availability filtering works
• Recently saved sorting works
• Title sorting works
• Price sorting works
• Pagination works
• Deleted courses are handled safely
• Loading, empty, and error states work
• Mobile and keyboard testing completed

Documentation

Added:

docs/course-bookmarks.md

The document covers API endpoints, database rules, frontend integration, optimistic updates, deleted-course handling, and manual testing.

Please update this PR before review:

• Complete the validation checklist ([x] for everything you've tested).
• Attach Before & After UI screenshots/GIFs.
• Include backend/frontend test logs (build, syntax, etc.) and manual testing evidence.

I'll review the PR after these are added.

Thanks for the review instructions. I have updated the PR validation checklist and added supporting testing evidence.